package br.com.it4.zmed.service;

import java.util.List;

import br.com.it4.framework.util.exception.BusinessException;
import br.com.it4.framework.util.exception.SystemException;
import br.com.it4.zmed.entity.Medico;
import br.com.it4.zmed.filter.MedicoFilter;

/**
 * Interface de acesso as funcionalidades de medico.
 * 
 * @author Mozart Silva (mozart.vsilva@gmail.com)
 * 
 */
public interface MedicoService {

    /**
     * Adiciona um determinado medico.
     * 
     * @param medico
     *            O medico a ser adicionado.
     * @return O medico adicionado.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     * @throws BusinessException
     *             Exceção caso ocorra erro na validação.
     */
    public Medico addMedico(Medico medico) throws SystemException, BusinessException;

    /**
     * Atualiza um determinado medico.
     * 
     * @param medico
     *            O medico a ser atualizado.
     * @return O medico atualizado.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     * @throws BusinessException
     *             Exceção caso ocorra erro na validação.
     */
    public Medico updateMedico(Medico medico) throws SystemException, BusinessException;

    /**
     * Remove um determinado medico.
     * 
     * @param medico
     *            O perfil a ser removido.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public void removeMedico(Medico medico) throws SystemException;

    /**
     * Consulta um determinado medico a partir da entidade.
     * 
     * @param crm
     *            O crm do medico a ser consultado.
     * @return A lista de medicos.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public Medico getMedico(String crm) throws SystemException;

    /**
     * Consulta a lista de medicos.
     * 
     * @param filtro
     *            Filtro para o medico.
     * @return A lista de medicos.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public List<Medico> getMedicos(MedicoFilter filtro) throws SystemException;

    /**
     * Consulta um determinado número de medicos a partir do filtro.
     * 
     * @param filtro
     *            Filtro para o medico.
     * @param registroInicio
     *            O registro de inicio retornado.
     * @param registroFim
     *            O registro final retornado.
     * @return A lista de medicos.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public List<Medico> getMedicos(MedicoFilter filtro, int registroInicio, int registroFim) throws SystemException;

    /**
     * Calcula o número de registros de medicos a partir pelo filtro.
     * 
     * @param filtro
     *            Filtro para o medico.
     * @return O número de registros encontrados.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public Long getMedicosCount(MedicoFilter filtro) throws SystemException;

}